home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-dhc-options-03.txt < prev    next >
Text File  |  1993-03-03  |  37KB  |  1,101 lines
  1.  
  2.  
  3.  
  4.  
  5. Network Working Group                    Internet Engineering Task Force
  6. Internet-Draft                                              S. Alexander
  7.                                                 Lachman Technology, Inc.
  8.                                                                 R. Droms
  9.                                                      Bucknell University
  10.                                                             January 1993
  11.  
  12.  
  13.                 DHCP Options and BOOTP Vendor Extensions
  14.  
  15. Status of this Memo
  16.  
  17.    This document is an Internet Draft.  Internet Drafts are working
  18.    documents of the Internet Engineering Task Force (IETF), its Areas,
  19.    and its Working Groups. Note that other groups may also distribute
  20.    working documents as Internet Drafts.
  21.  
  22.    Internet Drafts are draft documents valid for a maximum of six
  23.    months. Internet Drafts may be updated, replaced, or obsoleted by
  24.    other documents at any time.  It is not appropriate to use Internet
  25.    Drafts as reference material or to cite them other than as a "working
  26.    draft" or "work in progress."
  27.  
  28.    Please check the 1id-abstracts.txt listing contained in the
  29.    internet-drafts Shadow Directories on nic.ddn.mil, nnsc.nsf.net,
  30.    nic.nordu.net, ftp.nisc.sri.com, or munnari.oz.au to learn the
  31.    current status of any Internet Draft.
  32.  
  33.    Distribution of this memo is unlimited.
  34.  
  35. Abstract
  36.  
  37.    The Dynamic Host Configuration Protocol (DHCP) [1] provides a
  38.    framework for passing configuration information to hosts on a TCP/IP
  39.    network.  Configuration parameters and other control information are
  40.    carried in tagged data items that are stored in the "options" field
  41.    of the DHCP message.  The data items themselves are also called
  42.    "options."
  43.  
  44.    This document specifies the current set of DHCP options.  This
  45.    document will be periodically updated as new options are defined.
  46.    Each superseding document will include the entire current list of
  47.    valid options.
  48.  
  49. Table of Contents
  50.  
  51.     1.  DHCP Option Fields ........................................  2
  52.  
  53.  
  54.  
  55. S. Alexander, R. Droms     Expires July 1993                    [Page 1]
  56.  
  57. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  58.  
  59.  
  60.     2.  RFC 1084 Vendor Extensions ................................  2
  61.     3.  IP Layer Parameters per Host ..............................  7
  62.     4.  IP Layer Parameters per Interface .........................  9
  63.     5.  Link Layer Parameters per Interface ....................... 11
  64.     6.  TCP Parameters ............................................ 12
  65.     7.  DHCP Extensions ........................................... 13
  66.     8.  Security Considerations ................................... 18
  67.     9.  References ................................................ 18
  68.    10.  Authors' Addresses ........................................ 19
  69.  
  70. 1. DHCP Option Fields
  71.  
  72.    DHCP options have the same format as the BOOTP "vendor extensions"
  73.    defined in RFC 1084 [2].  Options may be fixed length or variable
  74.    length.  All options begin with a tag octet, which uniquely
  75.    identifies the option.  Fixed length options without data consist of
  76.    only a tag octet.  For fixed length options with data, the data
  77.    immediately follows the tag octet.  For variable length options, a
  78.    length octet follows the tag octet.  The length octet is followed by
  79.    length octets of data.
  80.  
  81.    All multi-octet quantities are in network byte-order.
  82.  
  83.    All of the "vendor extensions" defined in RFC 1084 are also DHCP
  84.    options.
  85.  
  86.    Option codes 128 to 254 (decimal) are reserved for site-specific
  87.    options.
  88.  
  89.    Except for the options in section 7, all options may be used with
  90.    either DHCP or BOOTP.
  91.  
  92.    Many of these options have their default values specified in other
  93.    documents.  In particular, RFC 1122 [3] specifies default values for
  94.    most IP and TCP configuration parameters.
  95.  
  96. 2. RFC 1084 Vendor Extensions
  97.  
  98.    This section lists the vendor extensions as defined in RFC 1084.
  99.    They are defined here for completeness.
  100.  
  101.    2.1. Pad Option
  102.  
  103.    The pad option can be used to cause subsequent fields to align on
  104.    word boundaries.  The code for the pad option is 0, and its length is
  105.    1 octet.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113. S. Alexander, R. Droms     Expires July 1993                    [Page 2]
  114.  
  115. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  116.  
  117.  
  118.     Code
  119.    +-----+
  120.    |  0  |
  121.    +-----+
  122.  
  123.    2.2. End Option
  124.  
  125.    The end option marks the end of valid information in the vendor
  126.    field.  Subsequent octets should be filled with pad options.  The
  127.    code for the end option is 255, and its length is 1 octet.
  128.  
  129.     Code
  130.    +-----+
  131.    | 255 |
  132.    +-----+
  133.  
  134.    2.3. Subnet Mask
  135.  
  136.    The subnet mask option specifies the local subnet mask as per RFC 950
  137.    [4].  The code for the subnet mask option is 1, and its length is 4
  138.    octets.
  139.  
  140.    If both the subnet mask and the router option are specified in a DHCP
  141.    reply, the subnet mask option MUST be first.
  142.  
  143.     Code   Len        Subnet Mask
  144.    +-----+-----+-----+-----+-----+-----+
  145.    |  1  |  4  |  m1 |  m2 |  m3 |  m4 |
  146.    +-----+-----+-----+-----+-----+-----+
  147.  
  148.    2.4. Time Offset
  149.  
  150.    The time offset field specifies the offset of the local subnet in
  151.    seconds from Coordinated Universal Time (UTC).  The offset is
  152.    expressed as a signed 32-bit integer.  The code for the time offset
  153.    option is 2, and its length is 4 octets.
  154.  
  155.     Code   Len        Time Offset
  156.    +-----+-----+-----+-----+-----+-----+
  157.    |  2  |  4  |  n1 |  n2 |  n3 |  n4 |
  158.    +-----+-----+-----+-----+-----+-----+
  159.  
  160.    2.5. Router Option
  161.  
  162.    The router option specifies a list of IP addresses for routers on the
  163.    local subnet.  Routers SHOULD be listed in order of preference.  The
  164.    code for the router option is 3.  The minimum length for the router
  165.    option is 4 octets, and the length MUST always be a multiple of 4.
  166.  
  167.  
  168.  
  169.  
  170.  
  171. S. Alexander, R. Droms     Expires July 1993                    [Page 3]
  172.  
  173. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  174.  
  175.  
  176.     Code   Len         Address 1               Address 2
  177.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  178.    |  3  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
  179.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  180.  
  181.    2.6. Time Server Option
  182.  
  183.    The time server option specifies a list of RFC 868 [5] time servers
  184.    on the local subnet.  Servers SHOULD be listed in order of
  185.    preference.  The code for the time server option is 4.  The minimum
  186.    length for this option is 4 octets, and the length MUST always be a
  187.    multiple of 4.
  188.  
  189.     Code   Len         Address 1               Address 2
  190.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  191.    |  4  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
  192.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  193.  
  194.    2.7. Name Server Option
  195.  
  196.    The name server option specifies a list of IEN 116 [6] name servers
  197.    on the local subnet.  Servers SHOULD be listed in order of
  198.    preference.  The code for the name server option is 5.  The minimum
  199.    length for this option is 4 octets, and the length MUST always be a
  200.    multiple of 4.
  201.  
  202.     Code   Len         Address 1               Address 2
  203.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  204.    |  5  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
  205.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  206.  
  207.    2.8. Domain Name Server Option
  208.  
  209.    The domain name server option specifies a list of Domain Name System
  210.    (RFC 1035 [7]) name servers on the local subnet.  Servers SHOULD be
  211.    listed in order of preference.  The code for the domain name server
  212.    option is 6.  The minimum length for this option is 4 octets, and the
  213.    length MUST always be a multiple of 4.
  214.  
  215.     Code   Len         Address 1               Address 2
  216.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  217.    |  6  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
  218.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  219.  
  220.    2.9. Log Server Option
  221.  
  222.    The log server option specifies a list of MIT-LCS UDP log servers on
  223.    the local subnet.  Servers SHOULD be listed in order of preference.
  224.    The code for the log server option is 7.  The minimum length for this
  225.    option is 4 octets, and the length MUST always be a multiple of 4.
  226.  
  227.  
  228.  
  229. S. Alexander, R. Droms     Expires July 1993                    [Page 4]
  230.  
  231. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  232.  
  233.  
  234.     Code   Len         Address 1               Address 2
  235.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  236.    |  7  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
  237.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  238.  
  239.    2.10. Cookie Server Option
  240.  
  241.    The cookie server option specifies a list of RFC 865 [8] cookie
  242.    servers on the local subnet.  Servers SHOULD be listed in order of
  243.    preference.  The code for the log server option is 8.  The minimum
  244.    length for this option is 4 octets, and the length MUST always be a
  245.    multiple of 4.
  246.  
  247.     Code   Len         Address 1               Address 2
  248.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  249.    |  8  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
  250.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  251.  
  252.    2.11. LPR Server Option
  253.  
  254.    The LPR server option specifies a list of RFC 1179 [9] line printer
  255.    servers on the local subnet.  Servers SHOULD be listed in order of
  256.    preference.  The code for the LPR server option is 9.  The minimum
  257.    length for this option is 4 octets, and the length MUST always be a
  258.    multiple of 4.
  259.  
  260.     Code   Len         Address 1               Address 2
  261.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  262.    |  9  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
  263.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  264.  
  265.    2.12. Impress Server Option
  266.  
  267.    The Impress server option specifies a list of Imagen Impress servers
  268.    on the local subnet.  Servers SHOULD be listed in order of
  269.    preference.  The code for the Impress server option is 10.  The
  270.    minimum length for this option is 4 octets, and the length MUST
  271.    always be a multiple of 4.
  272.  
  273.     Code   Len         Address 1               Address 2
  274.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  275.    |  10 |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
  276.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  277.  
  278.    2.13. Resource Location Server Option
  279.  
  280.    This option specifies a list of RFC 887 [10] Resource Location
  281.    servers on the local subnet.  Servers SHOULD be listed in order of
  282.    preference.  The code for this option is 11.  The minimum length for
  283.    this option is 4 octets, and the length MUST always be a multiple of
  284.  
  285.  
  286.  
  287. S. Alexander, R. Droms     Expires July 1993                    [Page 5]
  288.  
  289. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  290.  
  291.  
  292.    4.
  293.  
  294.     Code   Len         Address 1               Address 2
  295.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  296.    |  11 |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
  297.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  298.  
  299.    2.14. Host Name Option
  300.  
  301.    This option specifies the name of the DHCP client.  The name may or
  302.    may not be qualified with the local domain name.  See RFC 1035 for
  303.    character set restrictions.  The code for this option is 12, and its
  304.    minimum length is 1.
  305.  
  306.     Code   Len                 Host Name
  307.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  308.    |  12 |  n  |  h1 |  h2 |  h3 |  h4 |  h5 |  h6 |  ...
  309.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  310.  
  311.    2.15. Boot File Size Option
  312.  
  313.    This option specifies the length in 512-octet blocks of the default
  314.    boot image for the DHCP client.  The file length is specified as an
  315.    unsigned 16-bit integer.  The code for this option is 13, and its
  316.    length is 2.
  317.  
  318.     Code   Len   File Size
  319.    +-----+-----+-----+-----+
  320.    |  13 |  2  |  l1 |  l2 |
  321.    +-----+-----+-----+-----+
  322.  
  323.    2.16. Network Information Service Domain Option
  324.  
  325.    This option specifies the name of the client's NIS [11] domain.  The
  326.    domain is formatted as a character string consisting of characters
  327.    from the NVT ASCII character set.
  328.  
  329.    The code for this option is 14.  Its minimum length is 1.
  330.     Code   Len      NIS Domain Name
  331.    +-----+-----+-----+-----+-----+-----+---
  332.    |  14 |  n  |  n1 |  n2 |  n3 |  n4 | ...
  333.    +-----+-----+-----+-----+-----+-----+---
  334.  
  335.    2.17. Network Information Servers Option
  336.  
  337.    This option specifies a list of IP addresses indicating NIS servers
  338.    on the local subnet.  Servers SHOULD be listed in order of
  339.    preference.
  340.  
  341.    The code for this option is 15.  Its minimum length is 4, and the
  342.  
  343.  
  344.  
  345. S. Alexander, R. Droms     Expires July 1993                    [Page 6]
  346.  
  347. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  348.  
  349.  
  350.    length MUST be a multiple of 4..
  351.     Code   Len         Address 1               Address 2
  352.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  353.    |  15 |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
  354.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  355.  
  356.    2.18. Network Time Protocol Servers Option
  357.  
  358.    This option specifies a list of IP addresses indicating NTP [12]
  359.    servers on the local subnet.  Servers SHOULD be listed in order of
  360.    preference.
  361.  
  362.    The code for this option is 16.  Its minimum length is 4, and the
  363.    length MUST be a multiple of 4.
  364.     Code   Len         Address 1               Address 2
  365.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  366.    |  16 |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
  367.    +-----+-----+-----+-----+-----+-----+-----+-----+--
  368.  
  369. 3. IP Layer Parameters per Host
  370.  
  371.    This section details the options that affect the operation of the IP
  372.    layer on a per-host basis.
  373.  
  374.    3.1. IP Forwarding Enable/Disable Option
  375.  
  376.    This option specifies whether the DHCP client should configure its IP
  377.    layer for packet forwarding.  A value of 0 means disable IP
  378.    forwarding, and a value of 1 means enable IP forwarding.  The code
  379.    for this option is 17, and its length is 1.
  380.  
  381.     Code   Len  Value
  382.    +-----+-----+-----+
  383.    |  17 |  1  | 0/1 |
  384.    +-----+-----+-----+
  385.  
  386.    3.2. Non-Local Source Routing Enable/Disable Option
  387.  
  388.    This option specifies whether the DHCP client should configure its IP
  389.    layer to allow forwarding of datagrams with non-local source routes.
  390.    A value of 0 means disallow forwarding of such datagrams, and a value
  391.    of 1 means allow forwarding.  The code for this option is 18, and its
  392.    length is 1.
  393.  
  394.     Code   Len  Value
  395.    +-----+-----+-----+
  396.    |  18 |  1  | 0/1 |
  397.    +-----+-----+-----+
  398.  
  399.    3.3. Policy Filter Option
  400.  
  401.  
  402.  
  403. S. Alexander, R. Droms     Expires July 1993                    [Page 7]
  404.  
  405. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  406.  
  407.  
  408.    This option specifies policy filters for non-local source routing.
  409.    The filters consist of a list of IP addresses and masks which specify
  410.    destination/mask pairs with which to filter incoming source routes.
  411.    See RFC 1009 [13] for details.
  412.  
  413.    The code for this option is 19.  The minimum length of this option is
  414.    8, and the length MUST be a multiple of 8.
  415.  
  416.     Code   Len         Address 1                  Mask 1
  417.    +-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
  418.    |  19 |  n  |  a1 |  a2 |  a3 |  a4 |  m1 |  m2 |  m3 |  m4 |
  419.    +-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
  420.            Address 2                  Mask 2
  421.    +-----+-----+-----+-----+-----+-----+-----+-----+---
  422.    |  a1 |  a2 |  a3 |  a4 |  m1 |  m2 |  m3 |  m4 | ...
  423.    +-----+-----+-----+-----+-----+-----+-----+-----+---
  424.  
  425.    3.4. Maximum Datagram Reassembly Size
  426.  
  427.    This option specifies the maximum size datagram that the client
  428.    should be prepared to reassemble.  The size is specified as a 16-bit
  429.    unsigned integer.  The minimum value legal value is 576.
  430.  
  431.    The code for this option is 20, and its length is 2.
  432.  
  433.     Code   Len      Size
  434.    +-----+-----+-----+-----+
  435.    |  20 |  2  |  s1 |  s2 |
  436.    +-----+-----+-----+-----+
  437.  
  438.    3.5. Default IP Time-to-live
  439.  
  440.    This option specifies the default time-to-live that the client should
  441.    use on outgoing datagrams.  The TTL is specified as an octet with a
  442.    value between 1 and 255.
  443.  
  444.    The code for this option is 21, and its length is 1.
  445.  
  446.     Code   Len   TTL
  447.    +-----+-----+-----+
  448.    |  21 |  1  | ttl |
  449.    +-----+-----+-----+
  450.  
  451.    3.6. Path MTU Aging Timeout Option
  452.  
  453.    This option specifies the timeout (in seconds) to use when aging Path
  454.    MTU values discovered by the mechanism defined in RFC 1191 [14].  The
  455.    timeout is specified as a 32-bit unsigned integer.
  456.  
  457.    The code for this option is 22, and its length is 4.
  458.  
  459.  
  460.  
  461. S. Alexander, R. Droms     Expires July 1993                    [Page 8]
  462.  
  463. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  464.  
  465.  
  466.     Code   Len           Timeout
  467.    +-----+-----+-----+-----+-----+-----+
  468.    |  22 |  4  |  t1 |  t2 |  t3 |  t4 |
  469.    +-----+-----+-----+-----+-----+-----+
  470.  
  471.    3.7. Path MTU Plateau Table Option
  472.  
  473.    This option specifies a table of MTU sizes to use when performing
  474.    Path MTU Discovery as defined in RFC 1191.  The table is formatted as
  475.    a list of 16-bit unsigned integers, ordered from smallest to largest.
  476.    The minimum MTU value cannot be smaller than 68.
  477.  
  478.    The code for this option is 23.  Its minimum length is 2, and the
  479.    length MUST be a multiple of 2.
  480.  
  481.     Code   Len     Size 1      Size 2
  482.    +-----+-----+-----+-----+-----+-----+---
  483.    |  23 |  n  |  s1 |  s2 |  s1 |  s2 | ...
  484.    +-----+-----+-----+-----+-----+-----+---
  485.  
  486. 4. IP Layer Parameters per Interface
  487.  
  488.    This section details the options that affect the operation of the IP
  489.    layer on a per-interface basis.  It is expected that a DHCP client
  490.    can issue multiple requests, one per interface, in order to configure
  491.    interfaces with their specific parameters.
  492.  
  493.    4.1. Interface MTU Option
  494.  
  495.    This option specifies the MTU to use on this interface.  The MTU is
  496.    specified as a 16-bit unsigned integer.  The minimum legal value for
  497.    the MTU is 68.
  498.  
  499.    The code for this option is 24, and its length is 2.
  500.     Code   Len      MTU
  501.    +-----+-----+-----+-----+
  502.    |  24 |  2  |  m1 |  m2 |
  503.    +-----+-----+-----+-----+
  504.  
  505.    4.2. All Subnets are Local Option
  506.  
  507.    This option specifies whether or not the client can treat all subnets
  508.    as having the local MTU.  A value of 0 indicates that the client
  509.    should not treat subnets as being local for purposes of MTU
  510.    computation.  A value of 1 means that the client may treat all
  511.    subnets as being local.
  512.  
  513.    The code for this option is 25, and its length is 1.
  514.  
  515.  
  516.  
  517.  
  518.  
  519. S. Alexander, R. Droms     Expires July 1993                    [Page 9]
  520.  
  521. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  522.  
  523.  
  524.     Code   Len  Value
  525.    +-----+-----+-----+
  526.    |  25 |  1  | 0/1 |
  527.    +-----+-----+-----+
  528.  
  529.    4.3. Broadcast Address Option
  530.  
  531.    This option specifies whether or not the host portion of the
  532.    broadcast address for this interface should be all ones or all
  533.    zeroes.  A value of 0 indicates that the client should use zeroes
  534.    (e.g. 128.212.0.0).  A value of 1 means that the client should use
  535.    ones (e.g. 128.212.255.255).
  536.  
  537.    The code for this option is 26, and its length is 1.
  538.     Code   Len  Value
  539.    +-----+-----+-----+
  540.    |  26 |  1  | 0/1 |
  541.    +-----+-----+-----+
  542.  
  543.    4.4. Perform Mask Discovery Option
  544.  
  545.    This option specifies whether or not the client should perform subnet
  546.    mask discovery using ICMP.  A value of 0 indicates that the client
  547.    should not perform mask discovery.  A value of 1 means that the
  548.    client should perform mask discovery.
  549.  
  550.    The code for this option is 27, and its length is 1.
  551.     Code   Len  Value
  552.    +-----+-----+-----+
  553.    |  27 |  1  | 0/1 |
  554.    +-----+-----+-----+
  555.  
  556.    4.5. Mask Supplier Option
  557.  
  558.    This option specifies whether or not the client should respond to
  559.    subnet mask requests using ICMP.  A value of 0 indicates that the
  560.    client should not respond.  A value of 1 means that the client should
  561.    respond.
  562.  
  563.    The code for this option is 28, and its length is 1.
  564.     Code   Len  Value
  565.    +-----+-----+-----+
  566.    |  28 |  1  | 0/1 |
  567.    +-----+-----+-----+
  568.  
  569.    4.6. Perform Router Discovery Option
  570.  
  571.    This option specifies whether or not the client should solicit
  572.    routers using the Router Discovery mechanism defined in RFC 1256
  573.    [15].  A value of 0 indicates that the client should not perform
  574.  
  575.  
  576.  
  577. S. Alexander, R. Droms     Expires July 1993                   [Page 10]
  578.  
  579. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  580.  
  581.  
  582.    router discovery.  A value of 1 means that the client should perform
  583.    router discovery.
  584.  
  585.    The code for this option is 29, and its length is 1.
  586.     Code   Len  Value
  587.    +-----+-----+-----+
  588.    |  29 |  1  | 0/1 |
  589.    +-----+-----+-----+
  590.  
  591.    4.7. Router Solicitation Address Option
  592.  
  593.    This option specifies the address to which the client should transmit
  594.    router solicitation requests.
  595.  
  596.    The code for this option is 30, and its length is 4.
  597.     Code   Len            Address
  598.    +-----+-----+-----+-----+-----+-----+
  599.    |  30 |  4  |  a1 |  a2 |  a3 |  a4 |
  600.    +-----+-----+-----+-----+-----+-----+
  601.  
  602.    4.8. Static Route Option
  603.  
  604.    This option specifies a list of static routes that the client should
  605.    install in its routing cache.  If multiple routes to the same
  606.    destination are specified, they are listed in descending order of
  607.    priority.
  608.  
  609.    The routes consist of a list of IP address pairs.  The first address
  610.    is the destination address, and the second address is the router for
  611.    the destination.
  612.  
  613.    The code for this option is 31.  The minimum length of this option is
  614.    8, and the length MUST be a multiple of 8.
  615.  
  616.     Code   Len         Destination 1           Router 1
  617.    +-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
  618.    |  31 |  n  |  d1 |  d2 |  d3 |  d4 |  r1 |  r2 |  r3 |  r4 |
  619.    +-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
  620.            Destination 2           Router 2
  621.    +-----+-----+-----+-----+-----+-----+-----+-----+---
  622.    |  d1 |  d2 |  d3 |  d4 |  r1 |  r2 |  r3 |  r4 | ...
  623.    +-----+-----+-----+-----+-----+-----+-----+-----+---
  624.  
  625. 5. Link Layer Parameters per Interface
  626.  
  627.    This section lists the options that affect the operation of the data
  628.    link layer on a per-interface basis.
  629.  
  630.    5.1. Trailer Encapsulation Option
  631.  
  632.  
  633.  
  634.  
  635. S. Alexander, R. Droms     Expires July 1993                   [Page 11]
  636.  
  637. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  638.  
  639.  
  640.    This option specifies whether or not the client should negotiate the
  641.    use of trailers [16] when using the ARP protocol.  A value of 0
  642.    indicates that the client should not attempt to use trailers.  A
  643.    value of 1 means that the client should attempt to use trailers.
  644.  
  645.    The code for this option is 32, and its length is 1.
  646.     Code   Len  Value
  647.    +-----+-----+-----+
  648.    |  32 |  1  | 0/1 |
  649.    +-----+-----+-----+
  650.  
  651.    5.2. ARP Cache Timeout Option
  652.  
  653.    This option specifies the timeout in seconds for ARP cache entries.
  654.    The time is specified as a 32-bit unsigned integer.
  655.  
  656.    The code for this option is 33, and its length is 4.
  657.     Code   Len           Time
  658.    +-----+-----+-----+-----+-----+-----+
  659.    |  33 |  4  |  t1 |  t2 |  t3 |  t4 |
  660.    +-----+-----+-----+-----+-----+-----+
  661.  
  662.    5.3. Ethernet Encapsulation Option
  663.  
  664.    This option specifies whether or not the client should use Ethernet
  665.    Version 2 (RFC 894 [17]) or IEEE 802.3 (RFC 1042 [18]) encapsulation
  666.    if the interface is an Ethernet.  A value of 0 indicates that the
  667.    client should use RFC 894 encapsulation.  A value of 1 means that the
  668.    client should use RFC 1042 encapsulation.
  669.  
  670.    The code for this option is 34, and its length is 1.
  671.     Code   Len  Value
  672.    +-----+-----+-----+
  673.    |  34 |  1  | 0/1 |
  674.    +-----+-----+-----+
  675.  
  676. 6. TCP Parameters
  677.  
  678.    This section lists the options that affect the operation of the TCP
  679.    layer on a per-interface basis.
  680.  
  681.    6.1. TCP Default TTL Option
  682.  
  683.    This option specifies the default TTL that the client should use when
  684.    sending TCP segments.  The value is represented as an 8-bit unsigned
  685.    integer.  The minimum value is 1.
  686.  
  687.    The code for this option is 35, and its length is 1.
  688.  
  689.  
  690.  
  691.  
  692.  
  693. S. Alexander, R. Droms     Expires July 1993                   [Page 12]
  694.  
  695. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  696.  
  697.  
  698.     Code   Len   TTL
  699.    +-----+-----+-----+
  700.    |  35 |  1  |  n  |
  701.    +-----+-----+-----+
  702.  
  703.    6.2. TCP Keepalive Interval Option
  704.  
  705.    This option specifies the interval (in seconds) that the client TCP
  706.    should wait before sending a keepalive message on a TCP connection.
  707.    The time is specified as a 32-bit unsigned integer.  A value of zero
  708.    indicates that the client should not generate keepalive messages on
  709.    connections unless specifically requested by an application.
  710.  
  711.    The code for this option is 36, and its length is 4.
  712.     Code   Len           Time
  713.    +-----+-----+-----+-----+-----+-----+
  714.    |  36 |  4  |  t1 |  t2 |  t3 |  t4 |
  715.    +-----+-----+-----+-----+-----+-----+
  716.  
  717.    6.3. TCP Keepalive Garbage Option
  718.  
  719.    This option specifies the whether or not the client should send TCP
  720.    keepalive messages with a octet of garbage for compatibility with
  721.    older implementations.  A value of 0 indicates that a garbage octet
  722.    should not be sent. A value of 1 indicates that a garbage octet
  723.    should be sent.
  724.  
  725.    The code for this option is 37, and its length is 1.
  726.     Code   Len  Value
  727.    +-----+-----+-----+
  728.    |  37 |  1  | 0/1 |
  729.    +-----+-----+-----+
  730.  
  731. 7. DHCP Extensions
  732.  
  733.    This section details the options that are specific to DHCP.
  734.  
  735.    7.1. Requested IP Address
  736.  
  737.    This option is used in a client request (DHCPDISCOVER) to allow the
  738.    client to request that a particular IP address be assigned.  In a
  739.    server reply (DHCPOFFER), this option indicates the IP address that
  740.    the server is willing to offer.
  741.  
  742.    The code for this option is 38, and its length is 4.
  743.     Code   Len          Address
  744.    +-----+-----+-----+-----+-----+-----+
  745.    |  38 |  4  |  a1 |  a2 |  a3 |  a4 |
  746.    +-----+-----+-----+-----+-----+-----+
  747.  
  748.  
  749.  
  750.  
  751. S. Alexander, R. Droms     Expires July 1993                   [Page 13]
  752.  
  753. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  754.  
  755.  
  756.    7.2. IP Address Lease Time
  757.  
  758.    This option is used in a client request (DHCPDISCOVER or DHCPREQUEST)
  759.    to allow the client to request a lease time for the IP address.  In a
  760.    server reply (DHCPOFFER), a DHCP server uses this option to specify
  761.    the lease time it is willing to offer.
  762.  
  763.    The time is in units of seconds, and is specified as a 32-bit
  764.    unsigned integer.
  765.  
  766.    The code for this option is 39, and its length is 4.
  767.     Code   Len         Lease Time
  768.    +-----+-----+-----+-----+-----+-----+
  769.    |  39 |  4  |  t1 |  t2 |  t3 |  t4 |
  770.    +-----+-----+-----+-----+-----+-----+
  771.  
  772.    7.3. Option Overload
  773.  
  774.    This option is used to indicate that the DHCP "sname" or "file"
  775.    fields are being overloaded by using them to carry DHCP options. A
  776.    DHCP server inserts this option if the returned parameters will
  777.    exceed the usual space allotted for options.
  778.  
  779.    If this option is present, the DHCP client interprets the specified
  780.    additional fields after it concludes interpretation of the standard
  781.    option fields.
  782.  
  783.    The code for this option is 40, and its length is 1.  Legal values
  784.    for this option are:
  785.            Value   Meaning
  786.            -----   --------
  787.              1     use the "file" field to hold options
  788.              2     use the "sname" field to hold options
  789.              3     use both fields to hold options
  790.  
  791.     Code   Len  Value
  792.    +-----+-----+-----+
  793.    |  40 |  1  |1/2/3|
  794.    +-----+-----+-----+
  795.  
  796.    7.4. DHCP Message Type
  797.  
  798.    This option is used to convey the type of the DHCP message.  The code
  799.    for this option is 41, and its length is 1.  Legal values for this
  800.    option are:
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809. S. Alexander, R. Droms     Expires July 1993                   [Page 14]
  810.  
  811. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  812.  
  813.  
  814.            Value   Message Type
  815.            -----   ------------
  816.              1     DHCPDISCOVER
  817.              2     DHCPOFFER
  818.              3     DHCPREQUEST
  819.              4     DHCPDECLINE
  820.              5     DHCPACK
  821.              6     DHCPNAK
  822.              7     DHCPRELEASE
  823.  
  824.     Code   Len  Type
  825.    +-----+-----+-----+
  826.    |  41 |  1  | 1-7 |
  827.    +-----+-----+-----+
  828.  
  829.    7.5. Lease Identifier Cookie
  830.  
  831.    This option is used by a DHCP server to indicate the unique
  832.    identifier for an address lease.  The cookie is an opaque object of n
  833.    octets.  The cookie is used by the client to identify the lease in
  834.    future protocol transactions.
  835.  
  836.    The code for this option is 42.
  837.     Code   Len   Cookie Data
  838.    +-----+-----+-----+-----+---
  839.    |  42 |  n  |  c1 |  c2 | ...
  840.    +-----+-----+-----+-----+---
  841.  
  842.    7.6. Server Identifier
  843.  
  844.    This option is used by a DHCP client to indicate which of several
  845.    lease offers it is accepting.  The identifier is the IP address of
  846.    the selected server.
  847.  
  848.    The code for this option is 43, and its length is 4.
  849.     Code   Len            Address
  850.    +-----+-----+-----+-----+-----+-----+
  851.    |  43 |  4  |  a1 |  a2 |  a3 |  a4 |
  852.    +-----+-----+-----+-----+-----+-----+
  853.  
  854.    7.7. Parameter Request Vector
  855.  
  856.    This option is used by a DHCP client to request values for specified
  857.    configuration parameters.  The options are specified as a 32-octet
  858.    bit vector, where each bit that is set indicates the the client is
  859.    requesting a parameter for that option.  The order of bits in the
  860.    vector is big-endian within octets.  This means that the bit for
  861.    parameter code 0 is the left-most bit of the first octet.
  862.  
  863.    The code for this option is 44, and its length is 32.
  864.  
  865.  
  866.  
  867. S. Alexander, R. Droms     Expires July 1993                   [Page 15]
  868.  
  869. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  870.  
  871.  
  872.     Code   Len   Bit Vector
  873.    +-----+-----+-----+-----+---
  874.    |  44 | 32  |  c1 |  c2 | ... 30 more octets ...
  875.    +-----+-----+-----+-----+---
  876.  
  877.    7.8. Parameter Request List
  878.  
  879.    This option is used by a DHCP client to request values for specified
  880.    configuration parameters.  The list of requested parameters is
  881.    specified as n octets, where each octet is a valid DHCP option code
  882.    as defined in this document.  The client may order the option codes
  883.    as it desires.  The DHCP server is not required to return the options
  884.    in the requested order.
  885.  
  886.    The code for this option is 45.
  887.     Code   Len   Option Codes
  888.    +-----+-----+-----+-----+---
  889.    |  45 |  n  |  c1 |  c2 | ...
  890.    +-----+-----+-----+-----+---
  891.  
  892.    7.9. Message
  893.  
  894.    This option is used by a DHCP server to provide an error message to a
  895.    DHCP client in the event of a failure. The message consists of n
  896.    octets of NVT ASCII text, which the client may display on an
  897.    available output device.
  898.  
  899.    The code for this option is 46.
  900.     Code   Len     Text
  901.    +-----+-----+-----+-----+---
  902.    |  46 |  n  |  c1 |  c2 | ...
  903.    +-----+-----+-----+-----+---
  904.  
  905.    7.10. Maximum DHCP Message Size
  906.  
  907.    This option specifies the maximum length DHCP message that it is
  908.    willing to accept.  The length is specified as an unsigned 16-bit
  909.    integer.  The code for this option is 47, and its length is 2.  The
  910.    minimum legal value is 267 octets (264 octets for the DHCP header + 3
  911.    octets for the DHCP message type).
  912.     Code   Len     Length
  913.    +-----+-----+-----+-----+
  914.    |  47 |  2  |  l1 |  l2 |
  915.    +-----+-----+-----+-----+
  916.  
  917.    7.11. Renewal (T1) Time Value
  918.  
  919.    This option specifies the time interval from address assignment until
  920.    the client transitions to the RENEWING state.
  921.  
  922.  
  923.  
  924.  
  925. S. Alexander, R. Droms     Expires July 1993                   [Page 16]
  926.  
  927. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  928.  
  929.  
  930.    The value is in units of seconds, and is specified as a 32-bit
  931.    unsigned integer.
  932.  
  933.    The code for this option is 48, and its length is 4.
  934.     Code   Len         T1 Interval
  935.    +-----+-----+-----+-----+-----+-----+
  936.    |  48 |  4  |  t1 |  t2 |  t3 |  t4 |
  937.    +-----+-----+-----+-----+-----+-----+
  938.  
  939.    7.12. Rebinding (T2) Time Value
  940.  
  941.    This option specifies the time interval from address assignment until
  942.    the client transitions to the REBINDING state.
  943.  
  944.    The value is in units of seconds, and is specified as a 32-bit
  945.    unsigned integer.
  946.  
  947.    The code for this option is 49, and its length is 4.
  948.     Code   Len         T2 Interval
  949.    +-----+-----+-----+-----+-----+-----+
  950.    |  49 |  4  |  t1 |  t2 |  t3 |  t4 |
  951.    +-----+-----+-----+-----+-----+-----+
  952.  
  953.    7.13. Client-type
  954.  
  955.    This option is used by DHCP clients to optionally identify the type
  956.    and configuration of a DHCP client.  The information is a string of n
  957.    octets, interpreted by servers.  The definition of this information
  958.    is vendor specific. Servers not equipped to interpret the vendor-
  959.    specific information sent by a client MUST ignore it (although it may
  960.    be reported).
  961.  
  962.    The code for this option is 50.
  963.    Code   Len   Client-type
  964.    +-----+-----+-----+-----+---
  965.    |  50 |  n  |  i1 |  i2 | ...
  966.    +-----+-----+-----+-----+---
  967.  
  968.    7.14. Vendor Specific Information
  969.  
  970.    This option is used by DHCP clients and servers to exchange vendor-
  971.    specific information.  The information is an opaque object of n
  972.    octets, presumably interpreted by vendor-specific code on the clients
  973.    and servers.  The definition of this information is vendor specific.
  974.    The vendor is indicated in the client-type option.  Servers not
  975.    equipped to interpret the vendor-specific information sent by a
  976.    client MUST ignore it (although it may be reported).  Clients which
  977.    do not receive desired vendor-specific information SHOULD make an
  978.    attempt to operate without it, although they may do so (and announce
  979.    they are doing so) in a degraded mode.
  980.  
  981.  
  982.  
  983. S. Alexander, R. Droms     Expires July 1993                   [Page 17]
  984.  
  985. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  986.  
  987.  
  988.    The code for this option is 64.
  989.    Code   Len   Vendor-specific information
  990.    +-----+-----+-----+-----+---
  991.    |  64 |  n  |  i1 |  i2 | ...
  992.    +-----+-----+-----+-----+---
  993.  
  994. 8. Security Considerations
  995.  
  996.    Security considerations are not addressed in this memo.
  997.  
  998. 9. References
  999.  
  1000.    [1] Droms, R., "Dynamic Host Configuration Protocol", Internet Draft,
  1001.        January 1993.
  1002.  
  1003.    [2] Reynolds, J.K., "BOOTP Vendor Information Extensions", RFC 1084,
  1004.        December 1988.
  1005.  
  1006.    [3] Braden, R.T., "Requirements for Internet Hosts - Communication
  1007.        Layers", RFC 1122, October 1989.
  1008.  
  1009.    [4] Mogul, J., "Internet Standard Subnetting Procedure", RFC 950,
  1010.        August 1985.
  1011.  
  1012.    [5] Postel, J.B., and K. Harrenstien, "Time Protocol", RFC 868, May
  1013.        1983.
  1014.  
  1015.    [6] Postel, J.B., "Name Server", IEN 116, August 1979.
  1016.  
  1017.    [7] Mockapetris, P.V., "Domain Names - Implementation and
  1018.        Specification", RFC 1035, November 1987.
  1019.  
  1020.    [8] Postel, J.B., "Quote of the Day Protocol", RFC 865, May 1983.
  1021.  
  1022.    [9] McLaughlin, L., "Line Printer Daemon Protocol", RFC 1179, August
  1023.        1990.
  1024.  
  1025.   [10] Accetta, M., "Resource Location Protocol", RFC 887, December
  1026.        1983.
  1027.  
  1028.   [11] Sun Microsystems, "System and Network Administration", March
  1029.        1990.
  1030.  
  1031.   [12] Mills, D.L., "Internet Time Synchronization: The Network Time
  1032.        Protocol", RFC 1129, October 1989.
  1033.  
  1034.   [13] Braden, R.T. and J.B. Postel, "Requirements for Internet
  1035.        Gateways", RFC 1009, June 1987.
  1036.  
  1037.   [14] Mogul, J. and S. Deering, "Path MTU Discovery", RFC 1191,
  1038.  
  1039.  
  1040.  
  1041. S. Alexander, R. Droms     Expires July 1993                   [Page 18]
  1042.  
  1043. Internet-Draft  DHCP Options and BOOTP Vendor Extensions    January 1993
  1044.  
  1045.  
  1046.        November 1990.
  1047.  
  1048.   [15] Deering, S.E., "ICMP Router Discovery Messages", RFC 1256,
  1049.        September 1991.
  1050.  
  1051.   [16] Leffler, S. and M.J. Karels, "Trailer Encapsulations", RFC 893,
  1052.        April 1984.
  1053.  
  1054.   [17] Hornig, C, "Standard for the Transmission of IP Datagrams over
  1055.        Ethernet Networks", RFC 894, April 1984.
  1056.  
  1057.   [18] Postel, J.B. and J.K. Reynolds, "Standard for the Transmission of
  1058.        IP Datagrams Over IEEE 802 Networks", RFC 1042, February 1988.
  1059.  
  1060. 10. Authors' Addresses
  1061.  
  1062.    Steve Alexander
  1063.    Lachman Technology, Inc.
  1064.    1901 North Naper Boulevard
  1065.    Naperville, IL 60563-8895
  1066.  
  1067.    Phone: (708) 505-9555 x256
  1068.    EMail: stevea@isc.com
  1069.  
  1070.    Ralph Droms
  1071.    Computer Science Department
  1072.    323 Dana Engineering
  1073.    Bucknell University
  1074.    Lewisburg, PA 17837
  1075.  
  1076.    Phone: (717) 524-1145
  1077.    EMail: droms@bucknell.edu
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099. S. Alexander, R. Droms     Expires July 1993                   [Page 19]
  1100.  
  1101.